Splash screen

Learn how to create a splash screen for your Expo project and other best practices.

A splash screen, also known as a launch screen, is the first screen a user sees when they open your app. It stays visible while the app is loading. You can also control the behavior of when a splash screen disappears by using the native SplashScreen API.

The default splash screen is a blank white screen. It can be customized using the splash key in the project's app.json.

To create a splash image, you can use this Figma template. It provides a bare minimum design for an icon and splash images for Android and iOS.

For an in-detail walkthrough, see the video below:

Android screen sizes vary greatly with the massive variety of devices on the market. One strategy to deal with this is to look at the most common resolutions and design around that — you can see a list of devices and their resolutions here. Given that you can resize and crop our splash image automatically, you can stick with our dimensions as long as you don't depend on the splash image fitting the screen exactly. This is convenient because you can use one splash image for Android and iOS — less for you to read in this guide and less work for you to do.

The iOS Human Interface Guidelines list the device's screen sizes. In the video example, we use 1242 pixels wide (the width of the widest iPhone at the moment of writing) and 2436 pixels tall (the height of the tallest iPhone at the moment of writing). Expo will resize the image for you depending on the size of the device's size, and you can specify the strategy used to resize the image with splash.resizeMode.

After creating your splash screen, export it as a .png and save it in the assets directory. Currently, only .png images are supported. If you use another image format, making a production build of your app will fail.

Open the app.json and add the path as the value of splash.image to point to your new splash image. If you haven't renamed the default file name, it should be ./assets/splash.png.

Reopen the Expo Go and launch your project. You should see your new splash screen. However, there may be a delay before it appears in Expo Go. This doesn't happen in development builds or standalone apps. For more information, see Differences between environments.

On Android, you must press the notification drawer's refresh button. On iOS, it's required to close and re-open the Expo Go to see changes to the splash screen from the app.json.

If you set a background color other than white for your splash image, you may see a white border around it. This is due to the splash.backgroundColor property that has a default value of #ffffff.

To resolve it, set the splash.backgroundColor to be the same as our splash image background color, as shown in the example below:

Any splash image you provide gets resized to maintain its aspect ratio and fit the resolution of the user's device.

You can use two strategies for resizing: contain (default) and cover. In both cases, the splash image is within the splash screen. These work similar to the resizeMode in React Native , as demonstrated below:

Applying this to an example and remove the backgroundColor:

Here is the result:

In the above example, the image is stretched to fill the entire width while maintaining the aspect ratio. This is why the logo on the splash image ends up being larger than when resizeMode is set to contain.

To learn the difference between contain and cover in-depth, see blog post.

Any of the splash options can be configured on a platform basis by nesting the configuration under the android or ios in app.json (the same as how you would customize an icon for either platform). In addition, certain configuration options are only available on each platform:

On Android, you can set splash images for different device DPIs from mdpi to xxxhdpi.

On iOS, you can set ios.splash.tabletImage to have a different splash image on iPads.

If your app does not use Expo Prebuild (formerly the managed workflow) to generate the native android and iOS directories, then changes in the app.json will have no effect. For more information, see how you can customize the configuration manually.

On Android, the splash screen behaves in most cases the same as on the iOS. There is a slight difference when it comes down to standalone Android applications. In this scenario, extra attention should be paid to android.splash section configuration inside app.json.

Depending on the resizeMode you will get the following behavior on Android:

Your app can be opened from the Expo Go or in a standalone app, and it can be either published or in development. There are slight differences in the splash screen behavior between these environments.

In custom iOS builds, launch screens can sometimes remain cached between builds, making it harder to test new images. Apple recommends clearing the derived data folder before rebuilding, this can be done with Expo CLI by running:

See Apple's guide on testing launch screens for more information.

An app's icon is what your app users see on their device's home screen and app stores. Learn about how to customize your app's icon and what are the different requirements for Android and iOS.

Ask a question on the forums

Edit this page

Was this doc helpful?